home *** CD-ROM | disk | FTP | other *** search
/ Games of Daze / Infomagic - Games of Daze (Summer 1995) (Disc 1 of 2).iso / x2ftp / msdos / libs / pdcurs21 / readme.20 < prev    next >
Text File  |  1993-04-02  |  6KB  |  148 lines
  1.  
  2.                              PDCurses 2.0
  3.                   (Public Domain Curses for DOS and OS/2)
  4.  
  5.  
  6. INTRODUCTION:
  7.  
  8.     Well, here it finally is; PDCurses v2.0.
  9.     
  10.     PDCurses v2.0 is an almost total rewrite of PCCurses 1.4 done by John
  11.     'Frotz' Fa'atuai, the previous maintainer.
  12.     
  13.     This version has been tested with Microsoft C v6.0, QuickC v2.0 and
  14.     Borland C++ 2.0 under DOS and Microsoft C v6.0 and TopSpeed c v3.02
  15.     under OS/2 2.0. Also the library has been compiled successfully with
  16.     emx 0.8e, C Set/2 and Watcom 9.
  17.     Most testing was done with the large memory model where applicable.
  18.     The large memory model is probably the best model to use.
  19.     
  20.     The amount of testing has not been as extensive as I would have
  21.     liked, but demands on releasing a product have outweighed the
  22.     product's quality. Nothing new with that !!
  23.     Hopefully with wider circulation, more bugs will be fixed more quickly.
  24.     
  25.     I have included just 1 makefile which is suitable for dmake 3.8 for
  26.     both DOS and OS/2. The makefile does not rely on customisation of the
  27.     dmake.ini file.
  28.     
  29.     If you discover bugs, and especially if you have fixes, please let me
  30.     know ASAP.
  31.     
  32.     The source to the library is distributed as a zip file made with zip
  33.     1.9. You will need Info-ZIP unzip 5.0 to unzip.
  34.     Follow the directions below to compile the library.
  35.  
  36. DIRECTIONS:
  37.  
  38.     1.Create a new directory in which to unzip pdcurs20.zip. This will
  39.       create a curses directory and a number of subdirectories containing
  40.       source code for the library and utilities and the documentation.
  41.  
  42.     2.Make changes to the makefile where necessary:
  43.       Change the MODEL or model macro to the appropriate value (if it
  44.       applies to your compiler). Use model for Borland compilers.
  45.  
  46.       Change any paths in the defined macros to be suitable for your
  47.       compiler.
  48.  
  49.     3.Invoke DMAKE [-e environment_options] [target]
  50.     
  51.       where environment_options are:
  52.  
  53.         OS (host operating system)
  54.         COMP (compiler)
  55.         OPT (optimised version or debug version) - optional. default Y
  56.         TOS (target operating system) - optional. default OS
  57.  
  58.         see the makefile for valid combinations
  59.  
  60.         targets: all, demos, lcursesd.lib, manual...
  61.         
  62.         NB. dmake is case sensitive with targets, so those environments
  63.         that use an upper case model value (eg MSC) MUST specify the
  64.         library target as for eg. Lcursesd.lib
  65.  
  66.         The makefile is by default set up for Borland C++. The use of
  67.         -e environment_options override these defaults. Of you prefer
  68.         you can just change the defaults in the makefile and invoke it
  69.         without the -e switch.
  70.  
  71. OTHER NOTES:
  72.  
  73.     The documentation for the library is built into each source file,
  74.     a couple of specific doc files and the header files. A program is
  75.     supplied (manext) to build the manual. This program gets compiled
  76.     when you build the documentation.
  77.     
  78.     To generate the library response file correctly, I had to write a
  79.     quick and dirty program (buildlrf) to achive this. Originally the
  80.     makefiles just had statements like: "echo -+$(OBJ)\$* & >> $(LRF)"
  81.     which appended a suitable line to the response file. Unfortunately
  82.     under some combinations of makefiles and command processors (eg.
  83.     nmake and 4DOS) the & would get treated as stderr and the echo
  84.     command would fail.
  85.     
  86.     The original source for PDCurses that I received from the previous
  87.     maintainer contained support for the FLEXOS operating system. Not
  88.     having access to it, I could not test the changes I made so its
  89.     support has fallen by the wayside. If you really need to have PDCurses
  90.     running under FLEXOS, contact me and I will see what can be arranged.
  91.     
  92.     Under DOS, by default, screen writes to a CGA monitor are done via
  93.     the video BIOS rather than by direct video memory writes. This is
  94.     due to the CGA "snow" problem. If you have a CGA monitor and do not
  95.     suffer from snow, you can compile private\_queryad.c with CGA_DIRECT
  96.     defined. This will then use cause PDCurses to write directly to the
  97.     CGA video memory.
  98.  
  99. COMPILER-SPECIFIC NOTES:
  100.  
  101.     Microsoft C
  102.     -----------
  103.     It is possible with MSC 6.0 to build the OS/2 libraries and demo
  104.     programs from within DOS. This is the only case where it is possible
  105.     to specifiy the value of TOS on the command line to be OS2 and the
  106.     value of OS be DOS.
  107.  
  108.     C Set/2
  109.     -------
  110.     I have only tested the library using the migration libraries. I doubt
  111.     that the demo programs will work without them.
  112.  
  113.     emx
  114.     ---
  115.     Testing has been done with 0.8e of emx together with the 16_to_32
  116.     libraries.
  117.     The emx\lib directory should include the vio32.lib and kbd32.lib
  118.     libraries from the 16_to_32 package.
  119.  
  120. BUGS and UNFINISHED BUSINESS:
  121.  
  122.     PDC_set_ctrl_break() function does not work under OS/2.
  123.     win_print() and PDC_print() do not work under OS/2.
  124.     The file todo.man in the doc directory also lists those functions of
  125.     System V 3.2 curses not yet implemented. Any volunteers ?
  126.  
  127. ACKNOWLEGEMENTS:
  128.  
  129.     John 'Frotz' Fa'atuai, the previous maintainer for providing an
  130.     excellent base for further development.
  131.     John Burnell (johnb@kea.am.dsir.govt.nz), for the OS/2 port.
  132.     John Steele, Jason (finally NOT a John) Shumate....
  133.     for various fixes and suggestions.
  134.     Eberhardt Mattes (author of emx) for allowing code based on his
  135.     C library to be included with PDCurses.
  136.     Several others for their support, moral and actual.
  137.  
  138.  
  139. Good luck, Mark
  140.  
  141. ------------------------------------------------------------------------
  142. Mark Hessling                          email: M.Hessling@itc.gu.edu.au
  143. DBA, ITS                               phone: + 61 7 875 7691
  144. Griffith University                    fax:   + 61 7 875 7787
  145. Nathan 4111
  146. Qld Australia                          *** PDCurses maintainer ***
  147. ------------------------------------------------------------------------
  148.